package org.liziing.shortlink.admin.remote;


import com.baomidou.mybatisplus.extension.plugins.pagination.Page;
import org.liziing.shortlink.admin.common.convention.result.Result;
import org.liziing.shortlink.admin.remote.dto.req.*;
import org.liziing.shortlink.admin.remote.dto.resp.*;
import org.springframework.cloud.openfeign.FeignClient;
import org.springframework.cloud.openfeign.SpringQueryMap;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.PostMapping;
import org.springframework.web.bind.annotation.RequestBody;
import org.springframework.web.bind.annotation.RequestParam;

import java.util.List;

/**
 * 短链接后管请求中台接口
 */
@FeignClient("short-link-project")
public interface ShortLinkServiceActualRemoteService {

    /**
     * 创建短链接
     * @param requestParam
     * @return
     */
    @PostMapping("/api/short-link/v1/create")
    Result<ShortLinkCreateRespDTO> createLink(@RequestBody ShortLinkCreateReqDTO requestParam);


    /**
     * 批量创建短链接
     *
     * @param requestParam 批量创建短链接请求参数
     * @return 短链接批量创建响应
     */
    @PostMapping("/api/short-link/v1/create/batch")
    Result<ShortLinkBatchCreateRespDTO> batchCreateShortLink(@RequestBody ShortLinkBatchCreateReqDTO requestParam);

    /**
     * 修改短链接
     * @param requestParam 修改短链接参数
     */
    @PostMapping("/api/short-link/v1/update")
    void updateShortLink(@RequestBody ShortLinkUpdateReqDTO requestParam);

    /**
     * 分页查询
     * @return
     */
    @GetMapping("/api/short-link/v1/page")
    Result<Page<ShortLinkPageRespDTO>> pageLink(@SpringQueryMap ShortLinkPageReqDTO requestParam);

    /**
     * 查询分组内的短链接数量
     * @param requestParam
     * @return
     */
    @GetMapping("/api/short-link/v1/count")
    Result<List<ShortLinkGroupQueryRespDTO>> shortLinkQueryCount(@RequestParam("requestParam") List<String> requestParam);

    /**
     * 根据 URL 获取网站标题
     * @param url  网站链接
     * @return  网站标题
     */
    @GetMapping("/api/short-link/v1/title")
    Result<String> getUrlTitle(@RequestParam("url") String url);

    /**
     * 移至回收站
     * @param requestParam 请求参数
     */
    @PostMapping("/api/short-link/v1/recycle-bin/save")
    void saveRecycleBin(@RequestBody RecycleBinSaveReqDTO requestParam);

    /**
     * 分页查询回收站
     * @param requestParam 请求参数
     * @return 响应参数
     */
    @GetMapping("/api/short-link/v1/recycle-bin/page")
    Result<Page<ShortLinkPageRespDTO>> pageRecycleBin(@SpringQueryMap RecycleBinPageReqDTO requestParam);


    /**
     * 恢复短链接功能
     * @param requestParam 请求参数
     * @return 响应参数
     */
    @PostMapping("/api/short-link/v1/recycle-bin/recover")
    void recoverShortLink(@RequestBody RecycleBinRecoverReqDTO requestParam);

    /**
     * 删除回收站短链接功能
     * @param requestParam
     * @return
     */
    @PostMapping("/api/short-link/v1/recycle-bin/remove")
    void removeRecycleBin(@RequestBody RecycleBinRemoveReqDTO requestParam);

    /**
     * 访问分组短链接指定时间内监控数据
     *
     * @param requestParam 访分组问短链接监控请求参数
     * @return 分组短链接监控信息
     */
    @GetMapping("/api/short-link/v1/stats/group")
    Result<ShortLinkStatsRespDTO> groupShortLinkStats(@SpringQueryMap ShortLinkGroupStatsReqDTO requestParam);


    /**
     * 访问单个短链接指定时间内监控数据
     *
     * @param requestParam 访问短链接监控请求参数
     * @return 短链接监控信息
     */
    @GetMapping("/api/short-link/v1/stats")
    Result<ShortLinkStatsRespDTO> oneShortLinkStats(@SpringQueryMap ShortLinkStatsReqDTO requestParam);

    /**
     * 短链接监控单个链接 访问记录
     * @param requestParam
     * @return
     */
    @GetMapping("/api/short-link/v1/stats/access-record")
    Result<Page<ShortLinkStatsAccessRecordRespDTO>> accessRecordPage(@SpringQueryMap ShortLinkStatsAccessRecordReqDTO requestParam);


    /**
     * 短链接监控分组链接 访问记录
     * @param requestParam
     * @return
     */
    @GetMapping("/api/short-link/v1/stats/access-record/group")
    Result<Page<ShortLinkStatsAccessRecordRespDTO>> groupAccessRecordPage(@SpringQueryMap ShortLinkGroupStatsAccessRecordReqDTO requestParam);
}
